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HPX/OS I/O Subsystem External Reference Specification 



1.3 INTRDOUCTION 

r^s HPX Ooepating System, MPX/OS, Input/Output Subsystem 
includes all components required to perform the MPX/OS input and 
output Eicecutive Service Requests CESRs). These ESRs allow the 
HPX/OS user to perform physical data transfers, device control, 
and status checlfing. The ESRs processed by the MPX/os I/O 
Su3systei» a-e functionally divided into four C*»l groups as 
f »l 1 owst 

Device and File Management 
Event notification 
Data Transfers 
Device Control 

The first g-oup controls the access to all I/O devices and 
resolves device conflicts by delivering these resources to the 
requesting tasks on a priority basis. In order to generalize and 
facilitate a task's interface with the MPX/OS I/O Subsystem, a 
lojical connection betweeri the device and a task is created* 
Tinis logical connecTion is called the logical unit (lu), and is 
a numbfe- between one and sixty-three (1-63). Using either the 
file or device assignment features, the user requests the MPX/OS 
1/3 Subsystem to assign a device to a specified logical unit. 
Once the logical unit is assigned, the user may use the features 
in the otner grouos. This External Reference Specification 
describes the featur*es contained in ail four groups. 

In the NPX/OS* device availablity is divided into system and 
usar. System available devices are normally shared by multiple 
users, tnerefore management and control must be performed by the 
rtf»X/OS. Tne user available devices are normally unit record 
eqjipaent but may be any device not reserved for the system. 
Once a user available device is scheduled and assigned a Job 
Bxclusivaiy manages and controls tne device. A system available 
device accessed by a user is refered to as a Logical Device, 
while a system available device accessed by the system or a user 
available device accessed by a user is refered to as a Physical 
Device. The MPX/OS Logical Devices supported by the I/O 
SuosysteD aret 

Dumny (a device with all ESRs avaliable but does nothing) 

Files 

Message Queues 

Interactive Terainal 

Remote Batch Terminals 

ComBjnicat ions Network 

Tne MPX/OS Pnysical Devices are installation dependent but 
no'^maliy include all peripheral equipment. 
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HPX/3S I/O Subsystem Extarnal Reference Specification 

2.3 APPLICABLE DOCUHENTS 

Tie folloMing list of Control Data manuals document the MP-60 
E«jlatiDfi, the MPX Operating System and the MPX Product Seti 

17329110 MP-32 Computer System MP-60 Emulation Reference 
Hanual 

17329100 KP-60 Computer System hPX/OS Reference Manual 

10992100 MP-60 Computer System MPX/OS Operator's Guide 

11110000 MP-60 Computer System Iristallation Handbook 

1«»291700 MP-60 Computer System Program Command Console 
Reference Manual 

l<f063800 MP-60 Computer System Jtility Reference Manual 

litO622O0 MP-60 Computer System PRELIB Reference Manual 

11*061300 MP-60 Computer System COMPASS Reference Manual 

li»06llOO MP-60 Computer System FORTRAN Reference Manual 

17328900 MASS/HPSIM Reference Manual 



CCS-IOOl-A 2-i 



o 



,^"> 

Wy 



o 



o 



o 



MPX/as I/O Subsystem External Reference Specification 



3.3 FEATJRE OESCRIPTIONS 

Tie MPX Operating System Input/Output Subsystem features are 
inrfoKed by the execjtion of an MP-60 HON instruction. The MPX/OS 
rojtines, which are invoked by MON instruction, are called 
Exscutiwa Service Requests (ESRsJ . This section divides the 
MPX/OS I/O ESRs into four IW) groups. These groups and their 
associated ESRs are as follows: 

Device and File Management 

ftLLOCATE - reserve mass sto-age space. 

CLOSE ---- clear logical u'»it assignment. 

OE\/IC£ --- assign logical uiit to device. 

EXPAND "- increase mass storage space. 

MODIFY change mass storage attributes. 

Qp£isj -.--. assign logical unit To file. 

RELEASE -- reduce mass storage space. 

SAVEQ ---- alter uass storage attributes. 

Eveit Notification 

3U5f - check logical unit bjsy. 
JST -- Obtain unit status. 
rtUST - wait on multiple eveits. 
JXYP - obtain dynamic unit status. 

Data T~ansfer 

FORMAT - ir.itialize disk track. 

REAOLJ - read from logical unit. 

READOS - alternate read fron logical unit. 

viRlTLU - *«rite to logical unit. 

WRITOS - alternate write to logical unit. 

Device Control 

3K5P --- backspace unit. 

CLEAR -- clear unit. 

ERASE -- erase tape segment. 

FU^C --- Fu'^ction unit. 

REWD --- rewind unit. 

SELECT - select operating mode. 

5£3P --- search for end of file. 

J1>4T --- unsolicited interrjpt. 

JL3C --- locate record on unit. 

JNLO --- unload unit. 

HEDF --- write end of file on unit. 

OI(^G --- run diagnotstic test on unit. 

The follawing sections describe the ESRs contained within each 
of the aoova groups. 
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HPX/OS I/O Subsysten External Reference Specification 

3.1 OIVICE AND FILE MANAGEMENT 

3.1.1 Abstract 

lr\s Device and File Management feature is invoked by control 
ca'-ds aid Executive Service Requests (ESRs)* The control cards 
aid ESR are used to manage I/O resource allocation* The DEVICE 
aid OPEN ESRs are used to establish the linkage betiteen a task 
aid the device, while the CLOSE ESR removes this linkage. The 
otier Device and File Management ES^s allOM the user to create, 
maintain, and remove files in the lass storage system. 

3.1.2 Dascriptioi 

Tfia use" invokes the Device and File Management features with 
th3 follsMing ESRst 

ALLOCATE - reserve mass storage space. 
CLOSE ---- clear logical unit assignment. 
DEVICE --- assign logical unit to device. 
EXPAND --- increase mass storage space. 
M09IFY --- change mass storage attributes. 
OPEN ----- assign logical unit to file. 
RELEASE -- reduce mass storage space. 
SAVE3 ---- alter mass storage attributes. 

Ths Device and File Management ESRs used to manage the files on 
uass storage maintains a file directory on the system resident 
oack (SYSTEMCl). This file directory contains information about 
ti3 file necessary to uniquely identify and the locate the file 
ii the aass storage system. The user must create an 
caumunications area in memory before invoking a file management 
E3^. Ths first six words of this area contain the information 
lecessary to locate the file in the file directory. These first 
six Hords are refered to as the File Identification area and are 
descrbed in Figure 3-1. The appropriate Device and File 
Maiagemeit control card paramete"s are I e ft- lust if ied blank 
filled witiin The File Identification Area. 
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Tha File Name is fojrteen Ilk) characters long. 

Trts EditioT is two characters long. 

Tm Owf»er is four cf»aracters long« 

The Access is a four character privacy access key. 

The first fiva words must uniquely identify the file within the 
file systen* 



Figure 3-1 
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fns ALLOCATE control card and ES^ reserve space in the mass 
starage system and ouilds an entry in the file directory. Once a 
file is sucessfuily createdf the file Mill remain allocated 
uitil released (see RELEASE). 

Tna CLOSE control card and ESR clear The logical unit assignment 
by removing the linkage between ihtt task and the file or device. 
Hhsn the linkage for a file is renoved* the CLOSE ESR updates 
information contained in the file directory and returns the File 
Identification in the caller's parameter area (PARM) . All 
linkages established by a Job are removed automatically when the 
I 03 teruinates. 

The DEVICE and EQUIP control card, and the DEVICE ESR assign the 
specified logical unit to a Logical or Physical Device by 
estaol isii-^g a linkage between a task and the device. The 
logical unit must be a number between 1 and 63. The EQUIP 
control ca-'d and the DEVICE ESR also allow the assignment of a 
logical jnit to a previously assigned logical unit. 

Th3 EXPAND control card and EXPANDS ESR are used to increase the 
mass storage space reserved for a file. Before the EXPAND 
control card or ESR can be invoked the user must have 
establisned a I inf<age to the file with the OPEN control card or 
ES^. 

Tha MODIFir control card and ESR are used to alter the i|~) 
information contained in the file directory. This control card 
and ESR cannot be performed on an assigned file. If the file is 
assigned to this lob then an error indicator is returned. If the 
file is assigned to another J oo then the caller may request 
waiting jntil the file is closed by the other lob. 

Tna OPEN control card and ESR assign the specified logical unit 
to a file; thus establishing a linkage between a task and the 
device* Tne logical unit must be a number between i and 63. The 
OPiN control card and ESR also allow the assignment of the file 
1"% an exclusive access mode? therefore the caller can request 
waiting jntil exclusive access may be established or a previous 
exiluse access is cleared by the CL3SE control card or ESR. 

Tna RELEASE control card and ESR are used to remove some or all 
of tne soace reserved for a file. This contol card and ESR 
cannot be oerformed on a file which is assigned and the caller 
13/ reqjdst waiting until previous file assignments are cleare.d. 

Tna SAVE?F control card and SAVE3 ESR are used to change the 
attributes of an assigned tile. Before the control card or ESR 
can be invoked tne user must have established a linkage with the 
OPiN control card or ESR. 
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HPK/OS I/O Subsystem External Reference Specification 

3«1«3 Interfaces 

Tr»e fomat of the ALLOCATE control card call is as followst 

*%LLOCAr£( fntOwn,ed«aKf bsize«nbik3t NS/S»use»dtt didl« •.., dld8> 

w^ere* 

fn is the file name (O-l** characters). 

OHh is the owier (0-*t characters). 

ed is the edition (€-2 characters). 

3K is the privacy access Kay IQ'i* characters), 

asize is the logical record size (1-^096) • 

nblks is the number of blocks to reserve (1-65535). 

MS/S segmentation flag CNS-'Segmentation not allowed), 

jse is the alioMable file usage, 

dt is the device type number, 

didl is the pacKnanie« upto eigth packnames are alloMed. 



Ina ALL33ATE ESR format is as foHowst 

11 2 2 3 
78 56 3 k 1 

Reg "% tAi Address of File Allocation Area i 

.......... ♦ . ..4.. ....... -.4....... -- + 

Reg n*l I not jsed I 

♦ «- ..._ 4.-. _.-.-. .._«... ....-.+_..... + 

Reg n*2 J not used } 

4...... .«+ — . ._4..___ .___+......_- + 

Reg T*3 I not used J 

4...-.-.-- 4.. ...... ...4... ........ .4. ....... ♦ 

A = thread request if File Manager Busy. 
= 1 return if File Manager Busy. 
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T-^e foriat of the File Allocation Area is as follOMSt 

11 2 2 3 

78 56 3«» 1 

address I I 

File Identification 
address*-? I I 

♦ 4 4. ^. ^ 

address*^5 J sivll use J seg I Number of Blocks } 

+ + ..^ .. — ♦»-_..«.,«,. 4. 

address*? J Block Size I Device Type I 

♦-^ . 4 4. . + -_,- + 

addresses I End of List J 

♦— --- or + 

3daress*9 I Device Identification i 

+ + ^ ... — ,. . ^ 

i I 

addressf2!» I t 

♦ + 4... . ^. . ^ 

An example of the ALLOCATE ESR calling sequence is as follows! 

EXT ftLLOCATE Externally defined symbol 
L3A,R0 FAA File Allocation Area address 

HOMtRG ALLOCATE Monitor request 

FA!\ BSS 

TEXTC lit, SCRATCH File Name 

TEXTS 2t01 Edition 

TcXTC i»,OOPG Owner 

TEXTC «»,0N3S Privacy access key 

VFO '♦/0,'»/0,6/a, 16/100 

VFD 16/'»8fl,l6/5 

TEXTC 8,SYSTEM01 

GEN -1 
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HPX/OS I/O Subsystem External Reference Specification 

Tie CLOSE control card fornat is as foliowsi 

•:;LOSE(lult ...tl jn) 

M'tere the lu is the logical unit assigned to the file or 
device. 

Tta CLOSE ESR format is as followst 

11 2 2 3 
78 56 3 h 1 

t... ........ ......... -. ..4... ..................... -4- 

Reg ") iAi logical unit t 

4......... 4... ...... ...«...-. .. — 4... ...... ...4. 

Reg T*-! I not used I 

4...... ..4. -. — .---4....- ....4........ ....4 

Reg T*2 1 not used I 

4.. . ..4... ...... ...4. ........ ..4.. ........ .4. 

Rag n*^3 i not used i 

f...... ..4... ....... ..4.. ....... ...4.. ........ .-4^ 

A = tr»read request if File Manager Busy* 
= 1 return if File Manager Busy. 

Ah examoie of the calling sequence is as followst 

EXT CLOSE Externally defined symbol 

LOItRQ 15 Logical unit number 

HONtRO CLOSE Monitor request 
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Tr»8 forsnat of the E^UIP and DEVICE control cards are as foiiowst 

♦EClJIP(lu=d,...» 
♦EQUIP(1u1=Ij2,...I 
*0£\/IC£( lu=devtDl» ..f pn) 

rr>a DEVICE ESR format is as foMoMSi 

11 2 2 3 

78 56 Z W 1 

4......... ...4........ ....4.. — ...-....«.—.-••>--- <■ 

Reg T lAI Address of Device Assignment Area i 
+ «. ♦ — ♦ — ♦ 

Reg -^^l J logical unit i 

♦ ♦ --♦ — - — ♦ ♦ 

Reg n^Z I Requested Hardware Type I 

♦ + ♦ * ♦ 

Reg n*-3 1 logical unit t 

4............ 4..-. — ----.-♦- — _-—--— ♦- — --------♦ 

A = t-jread request if File Haiager busy. 
= 1 return if File Manager busy. 

Ai examol e of tne calling sequence is as foiiowst 

EXT DEVICE Externally defined symbol 

L3A,R0 DAA Device Assignment Area address ^-.^^ 

L0A,R1 15 LDgical unit number .4^ 

LDA,R2 2 Hagnetic Tape 

MONtRC DEVICE Monitor request 

DAA 8SS 

GEN -1 Aiy cr»it. 
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Tns foriat of the EXPAND Control Card is as folloHst 

^ •EXPANDdu.NOBLKS) 

w^ere* 

lu is the Idgicai unit. 

N03KS is the number of blocks added to the file* 

The EXPAND ESR format is as follows* 

11 2 2 3 
78 56 3«f 1 
♦ + ♦ ♦ ♦ 

Reg t iAl logical unit i 

♦ -- «.... ..................... 4^..-.-.-...^ 4- 

Reg '^*-l J Number of Blocks I 

4.-- ...4... ...... ...4. ......4......... ♦ 

Reg i«-2 I not used I 

............. 4. — .... ....^...........4. ...-.-.-4. 

Reg i*-3 I not used I 

4............4.......-....4->--- — ----+- — ---- - --4^ 

A = thread requast if File Manager busy* 
= 1 return if File hanager busy. 

Tie Numoer of Blocks is the number of logical blocks the file is 
to increase* 

A*) example of the calling sequence is as follows* 

EXT EXPANOQ Externally defined symbol 

LDA,RO 15 logical unit number 

LDA»R1 i»d Njmber of blocks to add 

HON,R0 EXPANDQ Monitor request 
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Th3 format of the MODIFY control card is as follows* g-^ 

*MOOIFy (of ntOOHnyoedvoaktnfntnownttedtnakfnblKSf 
S/NSf use*dt tdidlt •••? didS) 

meres 

3fn is tne old the File Name string, 

oown Is tie old owner string. 

3ed is tne old edition string. 

}aK is the old privacy access Key* 

•»fn is the new File Name string. 

Town is the lew Owner Narae string. 

-led is the lew edition string. 

naK is the new privacy access key. 

nblks is the number of blocks to be added to the file. 

NIS/S is the segmentation flag. 

jse is the allowable file usage. 

dt is the device type numoer. 

didl is the device identification. 

Tne MOOIFY ESR format is as follows: 

11 2 2 3 

78 56 3 k 1 

f..-........4...... ..^......-....4.. --, — — ♦ 

Reg n lAdi Address of File Modification Area i 
«. . — 4..... . .4... ...... ..-4... ...... ..-■«■ 

Reg n»-l J not used I (1 ) 

<. — --.- .- 4........ ....4.. .......... 4.. ....... ...4- ^-^ 

Reg n*2 J not usea I 

4^ ._- 4.. ....... ...4..... ....4.. — .......^4- 

Reg n*3 ! not used I 

4..... ....4.. — ........4..... . 4............ 4. 

A = 3 tnread request if File Manager busy. 
= 1 return if File Manager busy. 

3=3 thread request if file is opened* 
= I return if file is ooened. 
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Tha format of itt& File Modificatio** Area is as follows: 

11 2 2 3 

78 56 3«» 1 

addlress I 

Old File Identification 

address*^? t 

♦ --♦— ♦ ... ♦-- — - — 

address^^S i 

NeM File Identification 

address*ll I 

+ ♦ .-+ .— + — - 

address«-12 ISLVL I Jse I S I Number of Blocks 

♦ — ♦ ... ♦ . ♦ 

address*13 I End of List 

------ or 

address*-!'* I Device Identification 

♦.. ♦-—.-. ♦..^ ... ♦.— . 

i 



ad:iress«29 i 



At example of the calling sequence is as folloMs: 



o 



EXT 

LOA,R0 

HON,R0 



MODIFY 

FHA 

MODIFY 



Externally defined symbol 
File Modification Area address 
Mor^itor request 



FH^ 



BSS 

TIXTC 

TEXTC 

TEXTC 

TEXTC 

TiXTI 

TEXTC 

TEXTC 

T£XTC 

V-D 

T£XTC 

GEN 



i«»,TAP£10 

2.0u 

<»,OOSC 

l^*, SCRATCH 
2,01 



dtODPG 

VtONSS 

'»/0,«»/0, 8/0, 16/100 

8,SYSTEM01 

-1 



Did File Name 

Edition 

Owner 

Privacy access key 
NsM Fi le Name 

Edition 

Owner 

Privacy access key 
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rns format of the OPEN control card is as foilOMSt ^ 

♦DPEN<I u»f n,own,ed,ak,use,block) 

M'teres 

•^ is the lagicai unit numoer, 

^^ is up to fourteen character string for the File Name. 

3wr> is up to four character Owner NAME. 

2d is a two character edition. 

3k is up to four Character orivacy access key. 

>^5e is the file usage {RH, read/write, W, write* R» read!. 

olock referenced block number for partial open. 

Fhs OPE^ E3R format is as followst 

11 2 2 3 

C 78 56 3'* 1 
♦ — + ^.. ^ ^ 

Reg n lABf Address of File Description Area I 
♦ ♦ ♦ f— ♦ 

Reg '^♦l J lu I 

♦ ♦-- ♦ ♦ ♦ 

f'-eg i«-2 J not used I 

♦ ♦ ♦— + ♦ 

Reg n*-3 I not used t 

+ + ^ ^ . ^ 

A = 3 t-^read request if File Manager busy. \J 

- 1 return if File Manager bus/. 

B = thread request if fil^ is apened. 
= 1 return if file is opened. 
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Orr^e foraat of the File Description Area is as foiloMSt 
11 2 2 3 
78 56 Z h 1 
«. + ^ .- — +— — -«-- + 

address I I 

File Ideitif ication 
address*^? t I 

address^^S I Use i I Blocks I 

♦ ♦ .-«.. — ..... 4... + 

T^e Use field is a binary value Khich defines the use of the 
filet 

=0 File to be used for read/Mrite* 

-1 File to be used for read only. 

=2 File to be used for read/write, and set the highest block 

HPi tten to zero. 

Hf\sn the Block field is non-zero the file is opened where the 
iraiue ^^ tne block field is the next block to be read/written. 

Ai examole of thi: calling sequence is as foilowst 



o 







EXT OPEN Externally defined symbol 

LDA,RO FDA File Oecription Area address 

L0A»R1 15 Logical unit number 

MONtRO OPEN Monitor request 



F04 



3SS 







TEXTC 


lit, SCRATCH 


File Name 


TEXTS 


2.Q1 


Edition 


TEXTD 


!|,DDPG 


Owner 


TEXTC 


«»,DNSS 


Privacy access key 



VFD '»/0,*»/0, 8/0, 16/0 
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The foraat of the RELEASE control card is as folloNSS 

*^ELEASE(fn,OMn«ed»ak,nblks) 

Mieret 
fr» is U3 to fourteen character string for the File Name* 
jwn is up to four character 3Mner NAME. 
ad is a two character edition. 
aK is up to four character privacy access Key. 
•>blKs is the nuiuber of blocks to release. 

A character of R means '^elease unused. 

The character means the entire file. 

rna RELEASE ESR fornat is as folloMSt 

11 2 2 3 

78 56 3 1* 1 

Reg -J lABI Address of File Description Area I 

4....... — --+--« — ---.---4.- — — — ..-.<.-.»..._.«..♦ 

Reg n*l 2 not used I 

>-.... 4. -_-—.-«._ — —. — -- — f».-.--_-«-^ + 

Reg n«-2 I not used I 

«.-- --.---.4.-— . — -.-.-.«._.._ . ♦- — _.- + 

Reg 1*3 ! not jsed I 

......... »-- 4.----.— ._-»<..-«.--- — — 4. 

A = thread request if File Manager busy. 4^y 

= 1 return if File Manager busy. 

3=0 thread request if file is opened. 
= 1 return if file is opened. 

rna format of the File Description Area is as fol Ioms: 

11 2 2 3 

78 56 3V 1 
♦ 4 «. .-.<... 4. .. 4. 

address i 1 

File Identification 
3ddress«-5 I j 

addresses I Number of Blocks i 

4.-- .-.--.4.-.. — -_.... 4«. ....... 4- — ..- — 4. 

Tns Nunoar of Blocks is a binary number indicating the number of 
blocks to relsase. If the value is zero then the entire file is 
released* and if tie value = -1 tnen the unused portion of the 
file is rel eased* 
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An examoie if tt\6 calling sequence is as followst 

E<T RELEASE ExternaHy defined symbol 

LDfttRO FOA File Oecription Area address 

MON,R0 RELEASE Monitor request 



FDA BSS 

TEXTC 1«», SCRATCH File Name 

TEXTC 2,01 Edition 

TEXTC i»,ODPG Owner 

TEXTC ^,ONSS Privacy access key 

GEN -1 



O 
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Tm format of the SAVEPF control card is as folloMst 
*3A\/EPF( iu«fn«0Mr)«ed»3kfR) 



Mteret 
tu 
fn 
3Hn 

ed 

ak 



is the logical unit numoer* 

is up to fourteen character string for the File Name* 

is up to four character Owner NAME. 

is a two character edition* 

is up to four character privacy access Key* 

is the rapiacement flag. 



The SAVEa tSR format is as foiloMst 

11 2 2 3 
78 56 3*» 1 

Reg 1 lA) Address of the File Description Area i 

+ -- . ....4...^.. .....4.. ....... ...4... ...... ...■!- 

Reg n^t I logical unit 1 

4... . +.- ...... -.—---.+--.-. — ....... 

Reg T«-2 I not used I 

Reg ■^•■3 I not used I 

*• -.♦.-.,.- .{............f.......^ — ♦ 



O 



A = thread request if File Manager busy. 
= 1 return if File Manager busy. 

T-^e foriat of the File Description Area is as followst 

11 2 2 
7 8 5 6 2 k 

J 

File Identification 

I 

f...-. — ....4. ....... .4. ...... ...-4... ...... 

addresses 1 SLVLI Jse J S J Number of BlocKs 

4 ....-4. .- ._4 ...-...-4..-.-.... 

3ddress*7 I 

address*!** t 

4........... 4....... ....>........... 4.. ...... 



adilress 
ad dress* 5 



3 

1 
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An examoie of the calling sequence is as foHowst 

EXT SAVEQ Externally defined symbol 

LOAtRO FOA File Description Area address 

LOAt^l 15 Logical unit number 

MON,R0 SAVEQ Monitor request 



FDA BS3 

TEXTC l**, SCRATCH File Name 

TEXTC 2,01 Edition 

TEXTC «»,DDP& Owner 

TEXTS iftDNSS Privacy access key 

GEN -1 



o 



o 
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3.1.<» Aoorts aid Recovery g^ 

If the lob ter»i">ation is prevented from occurring while this 
rS« is ii progress. If the system aonormally terminates than the 
No-st case condition is the loss of usable disk space. 

3.1.5 Errors 

Whan a error in the call is detected, an error code is returned 
to the caller's oarameter area, PARK, PARM must be defined as an 
external in the user's program. An error code of zero CQ) 
S08Cifies sucessful processing. The the File Manager error codes 
a" 2 t 

1 Fi I s Manager Busy. 

3 Incomolete oarameter list. 

*» No file name soecified. 

5 No olocK size specified. 

6 No blocK count specified. 

7 IlUgal logical unit. 

11 Label file read error. 

12 File oreviously allocated. 

13 Insufficient label file space. 
tk lilegdl device label. 

15 To3 many devices. 

16 Insufficient contiguous space. 

17 Insufficient space available on the specified devices. 
13 File 3iza exceeds system limits. 

19 Block number exceed the numoer of blocks allocated. 

20 File Tot allocated. 

21 Operator cannot place devices on-line. 

22 Device label read error. 

23 Invalid logical unit. 
2** Logical unit previously defined. 

25 Incorrect Read/Write permission. 

26 File already opened with exclusive permission. 

27 Insufficient table space. 

28 T3S< Tas file open. 

29 III egal access key. 

30 Too ma^y device identifiers. 

31 LaosI file cannot be closed* 

32 Block size is 0. 

33 Nunoer of blociis is 0. 
3«» Segme-Jt count excceeds maximum. 



o 
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g^ 3«1«6 Per f orma'^ce 

TFiese features require a number of disk references and should 
lot be issued during tiae critical operations. 

3.1.7 Instaliatian Parameters 

The default system device list is created during system 
iiitializaf icn ana reflects the entries in the mass storage 
tasles nohich are installation dependent* 



O 
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3.2 El/EMT NOTIFICATION 

3.2.1 Aostract 

Tiis Event Notification feature provides device and request 
status infariation, required by a user to manage an assigaed 
lojical unit* 

3.2.2 Oescription 

Ti^a Eveit Motif ication feature is invoked by the foMowing ESRst 

BUSY - check logical unit busy. 

UST »- obtain unit status. 

MUST - wait on multiple events. 

UTY? - obtain dynamic unit status. 

Tnase ESRs are legal on ail devices and are described in the 
folloMiig oaragraphs. 

Tna BSY ESR returns the busy/not busy status of the specified 

l03ical jnit. The status is not a function of a particular I/O 

re:iuest but rather of the logical unit itself. The requesting 

task is scheduled after the request is completed. 



Ti3 'JST ES=^ returns the status of the requesting task's last 1/ 
~equest on the specified logical unit. If the I/O is stil 
sending* tne requesting task is placed in I/O wait until the 1/ 
is completed. 



I/O 
I 





T'^s KUST ESR allows the requesting task to be placed in a wait 
state pending the occurance of tne specified event(s). The 
requesting task supplies a 128 bit mask where bits 1-63 
correspond with tne end of operation on logical units 1-63 
resoective ly . Tne other bit (Q, &«»-127) correspond to the user 
defined events (OEFEVNTQ ESR). 

Tne UTYP ESR returns the hardware type of the specified logical 
unit. If the hardware type is a disk file* additional file 
description information is also returned. The requesting task is 
scnedulsd for execution after the request is completed. 

Ths STATJS ESR is called by a task to issue a status command to 
a specified logical unit. If The device is busy* the request is 
queued and the task is put into 1/3 wait. If the device is not 
ojsy, tne current status is rsquested from the device and the 
task is out into I/O wait and not scheduled for execution until 
tm operation is complete. 
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^iHmJ^ 



O 



3*2«3 Interfaces 

The BSY ESR format is as foiiows: 

11 2 2 3 
78 56 3<» 1 

♦ ♦ ♦ ♦ ♦ 

Reg ■» I LJ I 

♦ ♦ * ♦ * 

R«g "^^l J NOT JSEO J 

♦ ♦ ♦ ♦ * 

f^es ">*'2 ! NOT USED j 

♦ ♦ ♦ ♦ ♦ 

Reg '^♦S I NOT JSEO 1 

♦ ♦ ♦—— + + 

^•^ Logical unit for wnich ousy status is to be returned, 

^'^ examole of a calling sequence is as follows: 

^•^T BSY Externally defined symbol 

L3I,«0 10 Logical unit number 

MON,R0 BSY Honitor request 

Tna parameters returned in PARM are as foliowst 

11 2 2 3 
78 56 3«» 1 

♦ + ♦ ♦ + 

PAR^5 I B3 , 

♦ ♦ ♦- ♦ ♦ 

as = Zero (0)f uTit is not busy. 
= noT-zerOf unit is busy. 
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The UST ES=i fornat is as follOMs: 

11 2 2 3 
78 56 3<» 1 
♦- — — --- — -♦- ———.---♦- — •.-- — -- + 

Reg 1 I LJ J 

«>..>. .>-... -4— <—-•-- .......................... ...-4. 

Reg fi«-l I NOT JSED I 

Reg ^^2 I NOT liSEO I 

Reg n*3 J NOT JSEO I 

+ _.- ...-4.. —— .-.- 4.-----.----« +- — — -. — -.4. 

LJ Logical unit for which status is to be returned. 






Ai exa^Dpt e of a calling sequence is as folloMSi 

EXT JST Externally defined symbol 

LDItRO 10 Logical uhit number 

HONtRO JST Monifor request 

Tha paraneters returned in PARH are as follOHSt 

11 2 2 3 

78 56 3^ 1 
4.---. ......... — -.._ ............ .4... ...... 4. 

PARrt I JS I 

4......... -..4... ......... 4.. ...... ....4... ....... ..4. 

PARH»-i 1 ES 1 

4. ..4. ....... ...4..... . 4. ..... 4. 

J3 Normal unit status as described in Appendix B. 
£S Expanded status as described in Appendix 3» 
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r^a MUST £3R fornat is as foHowst 

11 2 2 3 

7 8 5 6 3 k 1 

* ♦ ♦ * ♦ 

R«9 *> 1 Mask bits (0-3l> j 

♦ * ♦ ♦ ♦ 

Res "J + l i Mask bits (32-63J I 

♦ ♦ ♦ * ♦ 

Reg 1*2 J Hask bits thk-95} j 

♦ ♦ ♦ ♦— * 

Re3 '>*3 i Mask bits (96-1271 | 

* ♦ ♦ ♦ 

Tna parameters returned in PARM are as foMoHst 

11 2 2 3 
78 56 3«i 1 
♦ ♦ *" ♦ ♦ 

PARM I US I 

♦ ♦ ♦ ♦ ♦ 

PARM«-1 1 rs , 

♦ ♦ ♦ + ♦ 

PftR"*-? i Event Dits (0-31) I 

♦ ♦ ♦ ♦ * 

PARM*3 I Event bits (32-63) 1 

♦ ♦ ♦ ♦ 4 

PARM*if 1 Event bits (6<^-95) | 

♦ ♦ ♦ ♦ ♦ 

PARM*5 } Event bits (96-127) J 

+ ♦ ♦ ♦ + 

•JS Unit status as described in Appendix 8, 

-S Expanded status as described in Appendix 3. 

Tie Eveit aits (0-127) are set to a one for each event which has 
occurred. The US and £S parameters are for the lowest numbered 
lojical jnit with a^ event bit set. 

At examDie of a calJing sequence is as foHowsi 

^'^^ MUST Externally defined symbol 

LDO,R0 MASKl Event Mask Bits 

L3D,R2 MASK3 Event Mask Bits 

MON,R0 MUST Monitor Request 
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T^9 UTYP E5R foraat is as foliowst 

11 2 2 3 

78 56 3«» 1 

♦ -----------♦—— — — --♦--- — — -- — ♦-——— — --♦ 

Reg T I LJ I 

♦ + 4.. —.-♦-.-..- ..4 

Reg -^^l 1 NOT JSEO I 

Reg ^*^^ ', NOT JSEO t 

♦ -. . + . 4. . 4... . 4. 

Reg n*3 I NOT JSEO I 

4.-- .---—4.- — —---»-> 4.. — -....- — 4_ ---.._...„ 4. 

LJ Logical unit for which hardware type is to be returned. 

X'\ example of a calling sequence is as foliowst 

Exr JTYP Externally defined symbol 

LOI,RO IQ Logical unit number 

MON,R0 UTYP Monitor request 

Tha paraneters returned in PARM are as foliowst 

11 2 2 3 

78 56 3*» 1 
4 .-4. — ----..4.-. « +.» ... 4 

PARM I HT I 

4---- 4....... --4- _.._._. 4 ..._-- — 4 

PARM^l I WORDS I 

4-- .....4 --------4.------.-- — 4 — .--,-^4 

PARM*2 J NBN I 

4-- + 4. .— . 4. 4 

PARM»3 I H3N I 

4--- — ---_— 4._---.-.....4...... — ---«4_ — -_.--_._ 4 

PARH*-'* I Flags I 

4-- .-----4.----..-— --4.. -.-.-_ 4.- — _-.-..., 4 

riT Hardware type» valid hardware types are defined in 

Aopendix C* 

MO^OS Njmber of words per blocK* returned for HT = 1 only 

N3M Njmber of next block to oe read or written (current 
block nuTiber)» returned for HT = 1 only 

^3^l Highest block number written (end-of-f i le) » returned 
for HT = 1 only 



O 
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Flags Bit 0* if set the device is a disk file 

3it 1« if set the device is a Magnetic tape 

Bit 2« if set the device is a blocked device 

Bit 3f if set the device is an input-only device 

Bit Ut if set the device is an output-only device 

Bit 5» if sat the device is an ASCII-only output device 

Bit 6f if set the device is an interactive terminal 

Bit 7t if set the device is a remote batch terminal 

Bit 6t if set the device is a communication network 



O 
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T-^a SFAFJS ESR format is as folloHsi 

11 2 2 3 
078 56 3<» 1 
♦ + ♦- — . . — + -«-— 4. 

Reg t I LJ I 

♦ ...+ +.« ... ^ .. — . ^ 

Reg n»-l J NOT JSEO I 

♦ 4. 4. + . ^ 

Reg •>*2 I NOT USED I 

♦ — 4. 4. 4.. — ,. ..4. 

Rsg r\*^3 I NOT JSEO J 

4. 4. 4. . 4. ... ^. 

LJ Logical jnit 



Art examole of a calling sequence is as followsi 

EXT STATUS Externally defined symbol 
LOItRO 10 Logical unit number 

MON,RQ STATUS Monitor request 



Th3 parameters returned in PARM are as followst 

11 2 2 3 

7 3 5 6 3 <♦ 1 
4. 4. 4 4. . 4 

PARM ! US 1 

4............ 4 .-.--.--4.-. -----. 4.,. ..-.-..._ 4 

PARM *1 I ES I 

4........... 4... .. .,4. ........ 4..... _ ,.4 

PARK ^2 I J 

HS 
PARM *n I } 

4. 4 4...-. 4. 4 

JS Mormal unit status as described in Appendix 8. 
£S Expanded statust as described in Appendix 8. 
^S Hardware status as described in Appendix 8. 
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3»i»k A33rts and Recovery 

Tt\3 follSMing two abort conditions are possible with these ESRst 

ft30RT 
TYPE CODE 

1 3 Logical unit not assigned to a device or file* 
1 8 Logical unit valje not between 1 and 63. 

3.2.5 Errors 
Nst applicable* 

3.2.6 PB~forinance 

T-** BSY, UST, MUST, and STATUS ESRs are used to synchronize I/O 
"equfeSt processina with tasK processing and could result in the 
tasK being placed in an I/O wait status. Use of the BSY ESR may 
degrade systen performance and fie MUST ESR could be used more 
efficiently in place of the BSY ES^. 

3.2.7 Installation Parameters 

Th2 valjes returned in PARM by the UTYP ESR way be modified 
during system generation. In addition* the peripheral equipment 
configuration is defined during system generation. 



CC5-I001-A 3-27 



MPK/OS I/O Subsystem External Reference Specification 

3.3 OATft TRANSFER 

3.3.1 Abstract 

ria abiltiy to transfer data between a tasK's memory buffer and 
3 device is supplied by this feature. 

3.3.2 Description 

Tie Data T-ansfer fsature is invoked by the following ESRst 

FORMAT - initialize disk track. 

REAOLU - read from logical unit. 

REA3DS - alternate read from logical unit. 

WRITLU - write to logical unit. 

HRITOS - alternate write to logical unit. 

riase E3? are legal on the devices as specified in Appendix A. 
Tna following paragraphs describe the Data Transfer ESRs. 

The FORMAT ESR writes the track addresses and timing marks 
lecessa-'y for subsequent data storage on a disk pack. The 
requesting task is scheduled for execution after the request is 
initiated, and must issue a 8SY, JST, or HUST ESR to determine 
wnan the request is completed. 

Tna READOS ESR initiates a data transfer from a specified 
lo3ical unit to a buffer residing in the requesting task's 
menory, fha requesting task is scheduled for execution after the 
request is initiated, and must issue a BSY, UST, or MUST ESR to 
determine nhen the request is completed. 

Tne REAOLJ ESR initiates a data transfer from a specified 
lajical unit to a buffer residing in the requesting task's 
menory. The requesting task is scheduled for execution after the 
-equest is initiated, and must issue a BSY, UST, or MUST ESR to 
determine Mhen the request is completed. 

Tns WRITOS ESR initiates a data transfer to a specified logical 
unit frofl a buffer residing iry the requesting task's memory. The 
requesting task is scheduled for execution after the request is 
initiateJ, and must issue a BSY, JST, or MUST ESR to determine 
whan the ooaration is completed. 

Tna MRITLU ESR initiates a data transfer to a specified logical 
unit fron a buffer residing in the -equesting task's memory. The 
requesting task is scheduled for execution after the request is 
initiated, and must issue a 3SY, UST, or MUST ESR to determine 
whsn the ooeration is completed. 
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3«3»3 I-jTe-faces 

Tie FORMAT ESR format is as f oi loM3t 

11 2 2 3 

78 56 3«i 1 
♦ + ^ ^ ^ 

Reg 1 i LJ I 

♦ ♦- ♦ — ♦ ♦ 

Reg •»*! I TRACK J 

Reg i*-2 J NOT JSED j 

♦ 4 <. ,. ^ . ^ 

!^eg '^♦S I NOT JSED i 

+ 4. ^^ ^ ^ 

LJ Logical unit 

TR*C< Track number to format 



An examole of a calling sequence is as followsi 

EXT FORMAT Externally defined symbol 

LDI,R«» 1*7 Logical unit number 

L0I,R5 SCO TracK number 

MQN,R«* FORMAT Monitor request 
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on 



l-J Logical unit to be read. 

Ai examale of the calling sequence is as follows: 

tXT READOS Externally defined symbol 

LOCA,R0 3UFA Byte address of buffer 

LDI»R1 !f8 NjHiber of bytes 

l"?J*of ^^ ASCII records in byte format 

L3ltf<3 15 Logical unit number 

MON,R0 REAODS Monitor request 



O 



ri3 READ3S and REAOLU ESR formats are as folloHSl 

11 2 2 3 
7 8 5 6 3 «» 1 

+ ♦ ♦ ♦ ♦ 

f^^S "> J AOO.^ESS 1 

♦ ♦ + ♦ ♦ 

Res 1*1 J LEN3TH , - 

Reg 1*2 1 rtooE * 1 

«eg n*3 1 '[j"' """* | 

ADDRESS The address of the first element (word or byte) of the 
ouffer is determined by the MODE parameter. 

LEMGTH The number of words (bytes) to be transfered. LENGTH 
i/alues may be from to Cf096 words (0 to 16,38't 
oytes). ft value of zero (0) is treated as the maximum 
LENGTH value of ti096 words (16,38«» bytes). 

MODE The data Transmission Mode (format) code* 

ASCII recordf word fomat 

16 ASCII record* i>yie format 

32 Binary record* word format ,0 



\J 
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TiM HRiras and HRITLU ESR formats a~e as folioMSt 

11 2 2 3 

78 56 3<» 1 

♦ ..+ ... --4... . ♦. — . — -.+ 

Reg -x I ADDRESS } 

♦ -- ._♦ . ^ -. — + -.- + 

Reg *»*! I LENSTH J 

♦ ._♦ . 4... 4 4 

■ Reg n*2 J MODE J 

4. +_- 4. 4 4 

Reg T«-3 1 LJ J 

♦ + 4 . 4 4 

ADDRESS The address of the first element (word or byte) of the 
suffer is determined by the MODE parameter. 

LENGTH The nuBber of words Cbytes) to be transfered. LENGTH 
values may be from 3 to «f096 words (0 to 16,38'f 
oytes). A value of zero (0) is treated as the maximum 
LENGTH value of *t096 words (lefSeit bytes). 

iODE The data Transmission Mode (format) code: 

ASCII record, word fornat 
16 ASCII record, byte format 
^1 32 Bimary record, word format 

LJ Logical unit to be read. 

Ai example of the calling sequence is as follows* 

Externally defined symbol 
dyte address of buffer 
Njmber of bytes 
ASCII records in byte format 
Logical unit number 
Monitor request 



o 



EXT 


WRITOS 


LDCAtRQ 


3UFA 


LOI.Rl 


1*8 


LDI,R2 


16 


L3I,R3 


15 


MON,R0 


WRITDS 
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3mi»i* A3>rts and Recovery 

Tts follSHing abort conditions are oossible with these ESRs* 



ABDir 

rypE C30E 
1 

2 
3 
if 
5 
o 
7 

a 

9 



O 



Operator rejected request to ready a unit. 

Buffer size large" than '»096 words. 

Logical unit unassigned. 

ftttsmpt to write on read-only file. 

An input was atteaoted into a read-only page. 

Hardware reject. 

An input or output was attempted upon a protected page. 

IHt^gai logical unit number. 

Comaand is not legal for assigned device. 



3.3.5 Errors 

Hardware aid data transmission error recovery procedures are 
error cods and device aependent. The MPX/OS error recovery 
pracedu^as are described in Appendix 0. 



3.3.6 Perfarmance 

SiTce trie data transfer features are scheduled for device 
manager orocessing in priority order, a lower priority request 
could wait for a higher priority request to complete. 






3.3.7 Instal I atiort Parameters 
Mot applicable. 



O 
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3.V DEVICE CONfROL 
3«%.l Aostract 

The ability to control a device is provided by the Device 
Cottroi features* 

3. '4. 2 Description 

The Device Control Feature is invoked by the following ESRs« 

BKS^ backspace unit. 

CLEft=4 -- clear unit. 

ERASE -- erase tape segment. 

FUN3 --- Function unit. 

REW3 -•- rewind unit« 

SELECT - select operating node. 

SEOF --- search for end of file* 

UINT --- unsoliCi.ted interrupt. 

ULOC --- locate record on unit* 

UNLD --- unload unit. 

WEOF --- write end of file on uTit. 

DIA5 --• run diagnotstic test o"* unit. 

Tiese ES^s are legal on the devices as specified in Appendix A, 
#\ a-^d the following paragraphs dsscrioe these ESRs. 

Tr\it 8KS=> £SR positions the logical unit before the oreceeding 
physical record or block unless tne logical unit is already at 
tna be^innin? of the tape or file. The requesting task is 
scteduled for execution after the -equest is initiated and must 
issue a BSY, UST, or MUST £3R to determine when the request is 
conpl eted. 

l'%i CLEA^ ESR is called by a task to clear out the current I/O 
opsration for a specified device* The command or data transfer 
is terminated at the point of receipt of the clear command. The 
task is pjt into I/O wait and not scheduled for execution until 
an end-of-operstion interrupt is recieved . If the device is not 
bjsy» tne clear request results in no action and the tash is 
scieduled for immediate execution. 

Tn3 ERASE ESR erases approximately 6 inches of magnetic tape in 

an effort to byoass faulty material. The requesting task is 

scheduled for execution after the request is initiated* and must 

issue a 3Sr, UST, or MUST ESR to determine when the request is 
cono Iet3d. 



o 
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rha FUNC ESR is used to send device dependant functions to a 
io3ical jnit. Tie requesting tasK is scheduled for execution 
after T">e request is initiated* and must issue a BSYt UST, or 
iJST ESR t3 deteraiie when the request is coapleted. 

Ths REWD E5R repositions a logical unit to the beginning-of -tape 
taOTI for magnetic tape devices ar^d to the first block for mass 
storage devices. Trie requesting task is scheduled for execution 
after t-ie request is initiated* and roust issue a BSY* USTf or 
MJST ESR Ta deteraiie \nh&n the request is coapleted* 

Tne SELiCr £SR is used to set the operating modes for a logical 
unit. The availaole mode selections for each device are 
specified in Appendix B* 

Tne SEO- ESR initiates a search ooeration (forward or backward) 
01 a specified logical unit for the next file marker* initial 
point of ihi file for backward searches, or end of the file for 
forward searches. Tne requesting task is scheduled for execution 
after tne request is initiated. and must issue a 3SY, UST, or 
MJST ESR to deteriine when the request is completed. 

Tne UINT ESR allows the requesting task to be notified when an 

unsolicited interrupt occurs on a logical unit. The unsolicited 

interrupt could be used to signal the occurance of a 
mai function. 

Tne JLOC ESR sets tne next block number of a logical unit to a 
~eau€Sted olock* If the requested block number is greater than 
tns allocated area* the r.ext block number is set to the last 
block written +1. Tne requesting task is scheduled for execution 
after tha request is completed. 

Tne UNLD ESR rewinds and makes not ready a magnetic tape reel. 
Tne requesting task is scneduled for execution after the request 
is initiated^ and must issue a asr* UST* or HUST ESR to 
determine when the request is completed. Following an unload of 
a tape tha tape arive is still assigned to the Job and the 
I ojical unit . 

Tne WEOr ESR causes an end-of-file mark to be written on the 
soscified logical unit (magneTic tape)* or sets the last block 
written value to the current block number (disk file). The 
requesting task is scheduled for execution after the request is 
initiated and must issue a BSY, UST* or MUST ESR to determine 
whan the request is completed. 



O 
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3»<**1 Interfaces 

T-ta BKSP ESR format is as foilowst 

11 2 2 3 
78 56 3«» 1 
♦ -.-. <. _ ..^. . .. — ^...... + 

Reg ■% I LJ I 

4...-. — --♦ -.4. . — 4. ... ^ 

■ Reg n*! I NOT USED J 

4. — 4 . 4... ^ ^ 

Reg T*2 1 NOT JSED 1 

4 „4 4 ..... 4 . + 

Reg -^frS J NOT JSED J 

4 4 . 4 . 4 . ^ 

LJ Logical unit to be bacKsoaced* 

An examale of a catling sequence is as foilOMSt 

tXT 3KSP Externally defined symbol 

LOI»RO 10 Logical unit number 

MQNtRO 3KSP Monitor request 
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Tna CLEftR £SR fornat is as foiioMSX 

11 2 2 3 

78 56 3«» 1 

♦----•------♦-------— — *- — — — -- — ♦-». — --«,«. 



I 



o 



♦ ♦ ♦ ♦ ♦ 

^<^9 1«-1 1 NOT JSEO I ' 

♦ * ♦ ♦ ♦ 

•^eg 1*2 I NOT JSEO I 

♦ ♦ ♦ ♦ ♦ 

RfeS '^*-3 J NOT JSEO I 

♦ -♦ ♦ ♦— ♦ 

i-J Logical unit 

A-* exainpl e of a calling sequence is as follOHs: 

EXT CLEAR Externally defined symbol 

LDItRO 20 Logical ur^it number 

HON,RQ CLEAR Monitor request 

Tie paraueters returned in PARri are as follows: 

11 2 2 3 

78 56 Z k 1 

PAR^ « " * *"" icl \ Q 

♦ + ^ ^ ^ 

C Clear status, if set an operation in progress was 
cleared* otherwise the device was not busy. 
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T-»a ERASE £SR fomiat is as follows} 

11 2 2 3 

78 56 3<f 1 

♦ ♦ ♦ ♦ ♦ 

Reg •» I LJ I 

♦ ♦ ♦ ♦ ♦ 

Reg *>♦! I NOT JSEO J 

♦ ♦ ♦ ♦ ♦ 

Reg •>*2 I NOT JSED I 

♦ ♦ ♦ ♦ ♦ 

Reg 1*3 I NOT USED j 

+ -+ *■ ♦— -♦ 

i-'i Logical unit to be erased* 

Ar> examole of a calling sequence is as foHoMSt 

^^^ ERASE Externally defined symbol 

LDItRO 10 Logical unit number 

}10N,RO ERASE Monitor request 

Trta FUNC ESR foraat is as foMoHSJ 

11 2 2 3 
78 56 Z k 1 
* — ♦ ♦ ♦-- ♦ 

Reg 1 J LU | 

♦- ♦ ♦ ♦— ♦ 

Reg n*! I Function Code 1 

♦ +- ♦ ♦— ♦ 

Reg n*2 J not usfed I 

♦- ♦ ♦ ♦— * 

Reg T*3 1 not used J 

+ + ♦ ♦ ♦ 

LJ Logical unit 

FuictioT Codes as defined in Appendix 8. 

An example of a calling sequence is as follows: 

E^T FUNC Externally defined symbol 

L3A,R0 AOOR Buffer starting address 

L3ItRl 2 Buffer length 

L3ZtR2 1 Function code 

LDI»R3 10 Logical unit number 

MON,R0 FUNC Monitor request 
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rha REW3 E3R foraat is as fol lowsi g^ 

11 2 2 3 O 
78 56 3l^ 1 

♦— ♦ -♦ ♦ -♦ 

Reg n J LU I 

♦ ♦ ♦ ♦ ♦ 

Reg '^•■1 1 NOT JSED j 

♦ ♦ ♦ ♦ ♦ 

Reg •^•'2 J NOT JSEO j 

♦ ♦ ♦ ♦ * 

Reg T»3 J NOT JSEO t 

♦ ♦ ♦ ♦ + 

LJ Logical unit to be positioned. 

An examole of a calling sequence is as foltowst 

-'<T REWO Externally defined symbol 

L3I,Ra 21 Logical unit number 

HON,Ra REWD Monitor request 

Tm select ESR format is as fol lows: 

11 2 2 3 

^8, 56 3 t* 1 

Reg i»-l I rtODE j 

♦ ♦ ♦ ♦ ♦ 

Reg n*2 I NOT JSEO j 

♦ ♦— - ♦ ♦ ♦ 

Reg 1*3 1 NOT JSEO I 

♦ ♦ * ♦ ♦ 

LJ Logical jnit 

^^^^ The modes for specific devices are listed in Appendix 3. 

An exaiDoJe of a calling sequence is as folloHst 

^^^ SELECT Externally defined symbol 

LDI»R0 12 Logical unit number 

L3I,R1 1 Select mode 

rtONtRO ScLECT Monitor request 
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Frte SEOF ESR format is as follows* 

11 2 2 3 

78 56 3 It 1 

♦ ♦ ♦ ♦ ♦ 

Reg •» 1 LJ j 

♦ ♦ ♦ ♦— ♦ 

Reg •>*l J OIRiDTION I 

♦ ♦ ♦ ♦ — + 

Reg n*-2 { NOT JSED J 

♦ ♦ ♦ ♦ ♦ 

Reg n«-3 J NOT JSED ! 

♦ ♦— ♦ ♦-- ♦ 

l-J Logical unit to be searched for End-of-File mark. 

9I?ECTI0N Direction of the search 
= 0« search forward 
= If search backward 

At examole of a calling sequence is as follows: 

E>^T SEOF Externally defined symbol 

LOIfRO 10 Logical unit number 

L3I»R1 Search forward 

MON.RO SEOF Monitor request 

Th2 iJINT ESR format is as follows* 

11 2 2 3 

78 56 3«f 1 
♦ «. + ^ ^ 

Reg 1 I LU J 

♦- + ♦ ♦ ♦ 

Reg T*l J not used I 

♦ ---. + . ^ + . ^ 

Reg 1^2 I not used t 

♦ <. # ^ ^ 

Reg n*3 I not used J 

♦ + ^ ^ ^ 

LJ Logical Jnit assigned to tha monitored device. 

At examole of the calling sequence is as follows! 

t'fT JINT Externally defined symbol 

LOI,R0 15 Logical unit number 

MON.RO JINT Monitor request 
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Tm JLOC £3R format is as fol iowst 

11 2 2 3 

78 56 3 k 1 

♦ ♦ ♦ -♦ + 

«eg II LJ I 

♦ — ♦— ♦ ♦ ^ 

Reg -ii-l { 31^ j 

♦ ._,. ... --♦-. . — +.. 4. 

Reg '^♦2 J NOT JSEO I 

♦ --^ -....-,... .,.-4. _ + 

Reg T»-3 I NOT JSEO I 

♦ ♦ . 1 . — ^ , ^ 

LJ Logical jnir to be positioned* 

3N Block number to which tia unit is to be set» This 

value will be the next block read or written. If 
the value = -l then the last block written +1 will 
will be used* 

^f^ exaiosle of a calling sequence is as follows: 

E'^T JLOC Externally defined symbol 

LQI,R3 10 Logical unit number 

LDI,Ri» 21* aiock number 

M0NtR3 JLOC Monitor request 

rh» UNL3 E3R fornsat is as follows: 

11 2 2 3 

78 56 3 k 1 

Reg -i i LU I 

Reg I'-l 1 NOT JSEO I 

«.-. _.+_-_«_- --«.-—_-—--_-♦-.«.».,«_. .^. 

Reg T*2 I NOT JSEO I 

+ 4. 4 ^ . ^ 

Reg n*3 J NOT JSEO I 

+ + ^ ^... ^ 

LJ Logical unit to be unloaded* 

A') examole of a calling sequence is as follows: 

E<T JNLD Externally defined symbol 

L3I»R0 10 Logical unit number 

MON,RC JNLD Monitor request 



O 



i'*"~^^ 

ky 



3-!»0 



CCS-IOOl-A 



o 



o 



o 



MPX/3S I/O Subsystem External Reference Specif ication 



Tr%i WEOF ESR fornat is as followst 

11 2 2 3 
78 56 3 h 1 
♦ ♦ ♦ ♦ + 

Reg 1 J LJ j 

♦ ♦ ♦ ♦ ♦ 

Reg '»»^1 1 NOT JSED i 

+ ^ ^ ^ . ^ 



Reg I'-a J NOT JSEO { 

♦ --♦ — ♦-- ♦ — ♦ 

Reg 1*3 1 NOT JSEO } 

+ # 4. ^ ^ 

LJ Loaicai unit End-of-File mark is to be written upon. 

Ai examole of a calling sequence is as foHoHSt 

E^T rtEOF Externally defined symbol 

LOI,R0 IQ Logical unit number 

MON,R0 WEOF Monitor request 
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rtia 0IA3 E3R format is as foHowsJ #^ 

11 2 2 3 ^^ 

7 8 5 6 Z k 1 
♦ ♦ ♦ ♦ ♦ 

f^eg *> J ADOf.ESS I 

♦ ♦ *■ ♦ ♦ 

l^eg T*l I LENGTH I 

* ♦ ♦ ♦ ♦ 

^eg 1*2 J COMMAND J 

♦ ♦ *■ ♦ f 

Reg T*3 I Equipment Code l lu t 

♦ ♦ * ♦ ♦ 

ADDRESS Buffer first word address 
LEMGTH 3uffe- length 

C01MAND Commands are device dependent and are listed for the legal 
devices in Appendix C. 

Eauiome^t code is tne hardware equioment identification. 

LJ Logical unit 

An examDie of a calling sequence is as followsi 



V>' 



^^^ OIAG Externally defined symbol 

LOA,R0 3FWA Buffer first word address 

LOI.Rl '+8 Buffer length 

L0I,R2 CHNU Comraand 

L3»R3 EQUP Equipment code 

LDI»R3 20»R3 Logical unit number 

MON,R0 '3IAG Monitor request 

r-is paraneters returned in FARM are as follows! 

11 2 2 3 

76 56 3 t* 1 

♦ ♦ ♦ ♦ ♦ 

PARM I STATUS J 

♦ ♦- — ♦ ♦ ♦ 

STATJS Diagnostic started 

1 Device does not exist 

2 Device assigned 

3 LU assigned 
'* No taole space avaiiaole 
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3»'*,k Aoorts and Recovery 

The following abort conditions are oossible with these ESRs: 

ABDRT 

ryPE C3DE 

1 1 Operator rejected request to ready a unit . 

1 2 Buffer size I arge-* than k09b words. 

^ 3 Logical unit unassigned. 

1 k Attempt to write on read-only file. 

i 5 An input was atte^ipred into a read-only page. 

1 3 Hardware reject. 

^ ^ ^^ input or output was attempted upon a orotected page. 

1 8 Illegal logical unit number. 

1 9 Command is not legal for assigned device. 

3*W»5 Errors 

Hardwara and data transmission error recovery procedures are 
ar-or code aid device dependent. The MPX/OS error recovery 
pracedu^es are described in Appendix D. 

3. If. 6 Performance 

^ Since the data transfer features are scheduled for device 
manager processing in priority order, a lower priority request 
cojjd wait for a higher priority request to complete. 

3.*. 7 Installation Parameters 
Not applicable. 
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tt,3 PROOJCT-LEVEL DESCRIPTION 

k,i PJBLICATIONS AFFECTED 

Nat ail laTuals in the following list of Control Data documents 
descpibi'»g the MP-60 Emulation, the HPX Operating System and the 
MPX Product Set are affected oy this External Reference 
Soscif icationt 

i»l&16300 MP-32 Camputer System MP-60 Emulation Reference 
nanuai 

1031730D MP-60 Camputer System MPX/OS Reference Manual 

10992100 MP-60 Computer System MPX/OS Operator's Guide 

11110000 MP-60 Computer System I-^stal I ation Handbook 

l«i29l70Q MP-60 Computer System Program Command Console 

Referenct Manual 

MP-60 Computer System Text Editor Reference Manual 

11*863800 MP-&Q Computer System Utility Reference Manual 

H»0622OO MP-60 Computer System PRELI3 Reference Manual 

lt»061300 MP-63 Camputer System COMPASS Reference Manual 

l!ta61103 MP-60 Computer System FORTRAN Reference Manual 

^.2 E3UIPMENT CONFIGURATION 

Eqjipmertt conf igj-at ions required to supoort the MPX Operating 
System Inpjt/Output Subsystem are as foiiowst 
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Njiibsr Df 3PUs 

Program states 

Manory U2-oit words) 

Ca-d reade- 

Liie priTts" 

Display cotsol e 

I'^teractivs terminals 

Mass storage (megabytes) 10 

Magnetic tapes 



IINIMUM 


TARGET 


MAXIMUM 


1 


1 


8 


6 


6 


ki 


9Q*3Qk 


131,072 


<»,19'»,30<t 


1 


1 


1 


1 


1 


2 


1 


1 


1 





1*8 


256 


10 


<»Q0 


1500 





2 


8 



o 
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INTERFACES TO OTHER SOFTWARE PRODUCTS 



Tt3 HPX Operating System Product Set members use the Executive 
Se-yice Requests described in section 3. Their exists an 
axsntsiya interface between the MPX/OS I/O Subsystem and the 
Interactive Terminal Subsystem (ITS). This interface is 
descriOBd in the preliminary I/O Subsystem Internal Haintenance 
Soecif ication* 






h,^ 



RESTRICTIONS AND LIMITATIONS 



Thi MPX Operating System Input/Output Subsystem is intended for 
the MP-32 arcnitecture, but the design will be flexible enough 
to operate on tne MPP. The MPX/OS I/O Subsystem, on either 
Tiachine, should support software developed using the existing 
Inout/Outpjt modules. 



f*.? RELIABILITY, AVAILA8LITY AND HAINT AINA3IL ITY REQUIREMENTS 

The I/O Subsystem is an integral part of the MPX Operating 
System and meets the reliability, availability, and 
^aintaiiabi I ity requirements of the MPX Operating System. 
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S.S GLOSSARY 

l^^^^^ The premature termination of a process 

whenever an irrecoverable situation occurs. 

Absolute Refers to actual machine address. 

*S-II American Standard Code for Information 

Interchange. The standard codet using a 
coded character set consisting of 7-bit 
coded characters. See American National 
Standard X3,k'l977 , 

Assemble The process b/ which an object (binary) 

module is created from the symbolic language 
program. 

Asynchronous Refers to a tyoe of serial transmission in 

which bit synchronization is accomplished 
for each character. 

33tch Class of tasks which run on a time available 

basis. 

3C-* Buffered Coromuiic ations Line Adapter is the 

controller interface to the RS-232C 
asynchronous communications lines. 

Bit A binary digit. 

*'3<^** A group of macnine words or bytes. Usually a 

collection of one or more records used in 

I/O to reduce the number of physical 
operations. 

3^1 fsr A portion of memory used to collect data in 

order to compensate for soeed differences 

between the processor and peripheral 
devices. 

3y<"e Eight (8) contiguous bits. 

CftLL The tranfer of control to a closed routine 

or task. A Executive Service Request, CALL, 
is used to activate a specific task. 







CDS-IOOl-A 5.^ 



o 



MPX/33 I/O Subsyste* External Reference Specification 



Callee The tasK initiated by the CALL Executive 

Service Request* 

CaHer The task initiating another routine or task. 

0L^ Comrounicatton Line Adapter* the hardware 

interface bet<«een the CPU and the 
communications line* 

CoBDile The process by Mhich an assembly module is 

created from a problem solving} language* A 
compiler usually generates several machine 
instructions from a single symbolic 
statement* 

ConiQon An area of memory that may be shared between 

tasks or routines* Tasks may communicate 
through common areas* 

Control Poi'>t Zero CYBER System Coitrol Point* ; 

CPJ Central Processing Unit. 

GRZ Cyclic Redundancy Check* 

3ata An area of memory that may be prestored with ^^ 

information at load time and may be shared [i^J 
between routines of a task. 

Oisoatoe** An operatir.g system routine that unthreads a 

task from the top of the ready list and 
places the task into execution* 

£S? Executive Service Request* name given to the 

MPX Operating System routines invoked by the 
HON instruction* 

File A collection of blocks and/or records* 

usually of related data. Each mass storage 
file has an entry in the system Label File. 

iTterruat A break in the normal processing flow 

usually caused by a hardware signal* 
Interrupts can oe enabled or disabled and 
occur with an associated priority. Processes 
that are interrupted are later resumed at 
the point of interruption* 



O 
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ITS 

lo: 

J ST 

J03 Manager 



Liarary 



Litkage 



Laader 

LJ 

MPX/OS 

MP3 



Interactive Teminal Subsystem. 

Input/Output Controller. 

The sequential and/or paral le t execution of 
tasks. Begins Mith a *JOB card and ends with 
a *£0J card. 

Job Control fable is an area of meinory 
containing info"mation controlling a given 
Job. 

A system task that processes the input 
stream of the lab. The Job Manager is a set 
of reentrant routines shared by all user 
lobs* 

A collection of frequently used« checKed-out 
programs maintained on an external device 
that car be loaded and executed separately 
or in conjuction with a user's program. 
Libraries must be arranged to minimize 
searching. 

The interconnection between routines or 
devices. The loader matches externals and 
entry points to establish program linkage. 
The Interactive Terminal Subsystem match Job 
terminal reqjests with terminal user 
connection requests to establish port 
linkage. 

A system! tas< that is used to load» 
relocate* and link binary object modules. 

Logical Unit* a number representing the user 
connection to a device. 

The MPX Operati-^g Systen. 

MP-60 CPU Emulation device. 

MP-60 CPU Emulation device (Mi I itarizedt or 
Ruggidized) • 
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^"^if^a' The relative location of an entry in a O 

table, Tha absolute location of an entry can 
be obtained by iDultiolying the ordinal by 
the number of machine Mords per entry and 
adding the starting address of the table. 

^^36 A i»096 Mord blocK of contiguous memory. 

Paging is a technique where a logical 
address is transformed via a set of page 
registers into a physical address. 

^^'^O Programmable Multiple Access Controller. 

f*^"^ The communications line between the CPU and 

the user. 

f*PJ COC CYBER/SOOO Peripheral Processor Unit. 

Pracess A software program equivalent to the MPX/OS 

terms tasks and Job. 

Priority A value sssigr^ed to an item in the system 

which facilitiates scheduling and processing 
within the operating system. 



^"8^e A list used to control the processing to be 

done. 

i^eady list A prioritized list of tasKs waiting for 

control of the CPU. 

Relocatable Refers to a program that has been prepared 

by a source language compiler or assembler 
to be loaded into any area of available 
memory. 

Resident The portion of the operating system which 

resides permanently in memory. 

'^-'^^^'^N A Executive Service Request that terminates 

a tasK and transfers control to the point in 
the caller whe*e the call originated. A task 
may return with or without release of 
memory. 

Soedule The determination of which processing is 

required next. 
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StacK A last-ini fipst-out queue* 

Status A stage or condition of an I/O request or a 

task. 

Sy^chro-^ous Serial transmission in Nhich characters are 

sent bitwise without start and stop bits. 

System Initialize Refers to the intial system load process 

where the resident is loaded* memory 
initialized* and the system tasks are 
started. 

T3>^ An independent unit of work that can compete 

for the resources of the system. A task may 
call and be called by other tasks. 

TCr Task Control Table is an area of memory 

containing information used to control a 
task. 

Terminal The device con-^ected to the user end of the 

PORT. 

Te-minats The process of completing a Job. A Job may 

terminate normally or aonormally. 

r^^ead A linked list af elements* the contents of 

each thread cell contains the address of the 
next thread cell and so on until a thread 
cell contains a value indicating the end of 
the list. 

Jtitity A routine. procedure or program that 

supports the operation of a system. 
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Apsendix A ESR ANO DEVICE CROSS REFERENCE CHART 

Tf\s foii^Mirig chart cross references ESRs and devices? ESRs not 
in the cnart are legal on all devices. 

F R R H H S 

E E R R E E 

RAA II8RFRLSUUHD 

MOOTTKAUEEELNEI 

ALDLOSSNWCOOLOA 

TUSUSPECOTFCDFG 

Logical Devices ♦-------- — — -----------—--..---* 

Oufflmy INNNNNNNNNNNNNNNi 

Massage Queues J I I I I I I N t 

Files IIIIIII INJ 

Iiteractive JI I IIIII IIIINI 

Remote Batch II I IIIII IIIINI 

Can. Network II IIIIIII IINI 

Physical Devices ♦--------—---------.------—.--+ 

1867 SMO/HMD I IIIIII IINI 

1333-5 FDD { II II III Nl 

1829 CARD READER II IIINIIN IIIINJ 

1827 PRINTER JIII INIIN III Nt 

1360-'* MA3 TAPE JIII INI N i 

2558-3 SOJPLER II I IINI 

L3CAL CRT IIIIIIII IIIIIINl 

3CLA/MJX IIIIIIII IIIIIINl 

HPCLA III I II I I IIN 



< 



I = ILLEGAL N = NULL blank = LEGAL 
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Aosendix 3 HAROWftRE/OEVICE CODES 

rr»a infDrmation returned in PARM for the UST, MUST, and STATUS 
ES^s is as f ot lows! 

1 2 2 3 

8 6 1 <» 1 

PARM I 1 unit status I 

«. ....... 4.. ......... 4-. . ...4.... 4--- — -----i- 

PARM*-! I Expanded Status J 

4. ♦ 

Tt\i unit status for each device is as folloMSt 

Ouiny 

Mo errsr oits or status used* 

Fil es 

31 Reject -- always set wr^en an error occurs. When no 

other error bits are set and this bit is set then the 

device is busy. 
30 Mot Ready -- when this bit and bit 31 are set, the 
^n^ Bass storage device is in a not ready condition. 

29 End of File -- when this oit and bit 31 are set, an 

attempt to read beyond the highest block written was 

at tempted. 
23 Traf^smi ssion Mode -- Afte" a data transfer this bit is 

one. 
27 End of Device — When mis bit and bit 31 are set a 

transfer beyond the highest available sector was 

atteiDpted. 
26 End of Allocated Blocks -- wnen this bit and bit 31 

are set a write beyond the highest allocated block was 

attempted and the file requires expansion. 
25 Data Error -- When this Pit and bit 31 are set a data 

error was encountered. 
2W Hardware Error -- When this bit and bit 31 are set a 

-jardware condition was encountered. 
23 Lost Data -- When this bit and bit 31 are set a lost 

data condition was encour^tered. 
22 Address Error -- When this bit and bit 31 are set a 

sector address error was encountered. 
21 SeeK Error -- When this Pit and bit 31 are set a seek 

arror was encountered. 
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31 Reject -- always set wnen an error occurs. When no 
other error bits are set and this bit is set then the 
device is busy. 

30 Mot Ready -- when this bit and bit 31 are set, the 
uass storage device is in a not ready condition* 

29 End of File -- when this bit and bit 31 are set, an 
attempt to read beyond the end of the message was 
at te. Tip ted* 

28 Tra-ismission Mode -- After a data transfer this bit is 
one. 

27 Not used, beyond the highest available sector was 
attempted. 

26 End of Allocated SlocKs -- when this bit and bit 31 

are set a write with no space available in the message 

queue was attempted. 
25 Data Erro~ -- when this oit and bit 31 are set a data 

arror xas encountered. 
Zk Hardware Error — when this bit and bit 31 are set a 

Tardware condition was encountered. 
23 Lost Data -- when this oit and bit 31 are set a lost 

data caidition was encountered. 

22 Address Error — whan this bit and bit 31 are set a 
sector address error was encountered. 

21 Seek Error -• when this oit and bit 31 are set a seek ^^-^ 
error was ercountered. 'i^ 

Interactive 

31 Reject -- always set when an error occurs. When no 
other drror bits are set and this bit is set then the 
device is busy. 

30 ^ot Ready -- when this oit and bit 31 are set, the 
terminal connection was lost. 

29 Not used. 

28 Transmission Mode -- After a data transfer this bit is 
zero* 

25-2? Mot used. 

ZW Hardware Error -- when tnis bit and bit 31 are set a 

hardware condition was encountered* 

23 Not used. 

22 3reaK -- when this bit is set a BRAEK was detected. 
21 Not used. 
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^eiote Satcri 

31 Reject -- always set mnen an error occurs. When no 

other error bits are set and this bit is set then the 

device is busy. 
30 Not Ready -- when this oit and bit 31 are sett the 

terainal connection Mas lost* 
. 29 Mot used. 
28 Transmission Hode -- After a data transfer this bit is 

zero* 
26-2? Not used. 
25 Data Error — when this oit and bit 31 are set a data 

error Mas encountered. 
Zk Hardware Error — when tlis bit and bit 31 are set a 

"hardware condition was encountered* 
23 Lost Data -- when this bit and bit 31 are set a lost 

data condition was encou'^tered* 
22 3reak -- when this bit is set BREAK was encountered. 
21 Framing Error — when fxLs bit and bit 31 are set a 

framing error was encountered* 



Coanunlcati ons NetworK 

31 -Reject -- always set whan an error occurs* When no 

other error bits are set and this bit is set then the 

device is busy* 
30 Not Ready -- when this oit and bit 31 are set, the 

terminal connection was lost* 
29 Mot used. 
28 Transmission Mode -- After a data transfer this bit is 

zero. 
26-2? Not used. 
25 Data Error -- when this oit and bit 31 are sat a data 

error was encountered* 
Zk Hardware Error -- when this bit and bit 31 are set a 

hardware condition was encountered. 
23 Lost Oats -- when this bit and bit 31 are set a lost 

data condition was encouttered* 
22 Break -- when this bit is set BREAK was encountered. 
21 Framing Error — when this bit and bit 31 are set a 

framing error was encountered* 
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18d7 SMO/MiO 

31 Reject — always set what an error occurs. When no 
other errar bits are set and this bit is set then the 
device is busy* 

30 Mot Ready — when this bit and bit 31 are set, the 
Ttass storage device is in a not ready condition. 

29 Not Used. 

28 Transmission Mode -- After a data transfer this bit is 
one. After a UINT instrjction only this bit is set 
*ihen an urisolicited interrupt occurs. 

27 »<rite Protect Fault -- ^hen this bit and bit 31 are 
set a write to a protected unit was attempted. 

26 Mot used. 

25 Data Error -- when this bit and bit 31 are set a data 

arror (nas encountered. 
2<» ^ardwar8 Error — when this bit and bit 31 are set a 

Tardware condition was encountered. 
23 Lost Data -- when this oit and bit 31 are set a lost 

data coidition was encouitered. 

22 Address Error — when this bit and bit 31 are set a 
sector address error was encountered. 

21 Seek Error -- when this oit and bit 31 are set a seek 
error was encountered. 

1833-5 FJO Q 

31 Reject -- always set wh3n an error occurs. Khen no 
other error bits are set and this bit is set then the 
device is busy. 

30 Mot Ready -- when this bit and bit 31 are set, the 
uass stora^^e device is in a not ready condition. 

29 Mot used. 

28 Trarismission Hode -- Afte- a data transfer this bit is 
3r>e. After a UINT request only this bit is set to 
indicate an unsolicited interrupt occurance. 

27 Write Protect Fault — ^hen this bit and bit 31 are 
set a write to a protected unit was attempted. 

2d Not used. 

25 Data Error -- when this bit and bit 31 are set a data 

error /nas encountered. 
2'fr Hardware Error -- when tnis bit and bit 31 are set a 

hardware condition was encountered. 

23 Lost Data -- when this ait and bit 31 are set a lost 
data condition was encountered. 

22 Add-ess E^ror -- when this bit and bit 31 are set a 
sector address error was encountered. 

21 Seek Error -- when this bit and bit 31 are set a seek 
error was encountered. 
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18>9 Reader 

31 Reject -- always set whef> an error occurs* When no 

other error bits are set and this bit is set then the 

device is busy. 
30 Not Ready -- when this bit and bit 31 are set, the 

aass storage device is in a not ready condition. 
29 End of File -- when this bit and bit 31 are set, a 

card with a 7 and 8 puTch in the first column was 

read. 
28 Transmission Mode -- After a data transfer this bit is 

set to indicate the type of card (0 - ASCII, 1 - 

Binary) . 
27 Feed Failure -- when this bit and bit 31 are set a 

card failed to feed through the read station. The card 

reader also goes Not Ready. 
25 Not used. 
25 Oata Error -- when this bit and bit 31 are set a data 

error was encountered. 
Zk ^ardware Error — when this bit and bit 31 are set a 

lardware condition was encountered. 
23 Input Tray Empty — when this bit and bit 31 are set 

the input hopper is empty, the card reader is Not 

^eady and no card was read. 
21-22 Not used. 



1827 PriTtsr 

31 Reject -- always set when an error occurs. When no 

other errar bits are set and this bit is set then the 

device is busy. 
30 Not Ready — when this bit and bit 31 are set, the 

aass storage device is in a not ready condition. 
29 Not used. 
28 Transmission Mode -- After a data transfer this bit is 

zer9. 
26-27 Not used. 
25 Oata Error -- when this bit and bit 31 are set a data 

error was encountered. 
Zk Hardware Error -- when tnis bit and bit 31 are set a 

nardware condition was encountered. 
22-23 Not used. 
21 Paper Fault -- when this bit and bit 31 are set the 

orinter is nornially out of paper and Not Ready. 
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31 Reject -- always set when an error occurs. When 

other error bits are set and this bit is set then the 

device is busy. 
30 Not Ready -- when this bit and bit 31 are set, the 

switch on the coupler card is switched in the off line 

oositio'Y. 
29 End of file — when this bit and bit 31 are setf an 

end of file condition was sensed* 
28 Transmission Mode -« After a data transfer this bit is 

set to indicate the mode of the data transfer (0 - 

ASCII, 1 - Binary). 
27 End of Record -- when this bit and bit 31 are set an 

end of record was encountered. 
26 Not usad. 
25 Oata Error -- when this oit and bit 31 are set a data 

error was encountered. 
Zk ^a^dware Error — when this bit and bit 31 are set^ a 

nardware condition was encountered. 
23 "^ot used. 
22 Not used. 
21 Not used. 



O 



ISaO-t^ Taoa 

31 Reject -- always set wnen an error occurs. When no 

other error bits are set and this bit is set then the 

device is busy. 
30 Not Ready -- when this oit and bit 31 are set, the 

aass storage device is in a not ready condition. 
29 End of File -- when this bit and bit 31 are set, read 

or wrire of a tape marK occured. 
28 Transmission Mode — After a data transfer this bit is 

one. 
27 Write Protect Fault -- when this bit and bit 31 are 

set a write to a protected unit was attempted. 
26 Not used. 
25 Data Error -- when this Oit and bit 31 are set a data 

error Mas encountered. 
Zk Hardware Error — when tnis bit and bit 31 are set a 

nardware condition was encountered. 
23 Lost Uata -- when this Oit and bit 31 are set a lost 

data condition was encountered. 
22 Load Point -- when this oit is set the tape unit is 

resting at load point, 
21 End of Taoe -- when this bit and bit 31 are set the 

End of Taos foil was encountered. 

2558-3 3ojoler i^^ 
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Local CRT 

31 Reject -- alMays set when an error occurs. When no 
other error bits are set and this bit is set then the 
device is busy. 

21-30 Mot used -- the status information is contained in the 
Peripheral Information Table (PITI, 

3C_A/MU)( 

31 Reject -- always set wnen an error occurs. When no 
other error bits are set and this bit is set then the 
device is busy. 

21-30 Mot used. The status information is contained in the 
PIT. 



MPCLA 



no 



31 Reject -- always set when an error occurs. When 

other error bits are set and this bit is set then the 
device is busy. 

21-30 Mot used. The status information is contained in the 
PIT. 



If no error conditions are set, tnen the Extended Status will 
contain tne number of bytas not transfered; otherwise the 
Extended Status will contain furtner deliniation of the error 
condition. 



Tns MOOE oarameter in the SELECT ESR is defined for the 1829 
ca-d reader as follows: 

2 3 

9 1 



*■' 



■ *■ 



Reg 1+1 I i M } 



*• 



• 4- 



= Select 029 Hollerifj conversion mode 

1 = Select 926 Hollerith conversion mode 

2 = Select ASO Holleritn conversion mode 



COS-IOOl-A B-7 



MPX/OS I/O Suttsystem External Reference Soecif ication 



r-ia MOD£ Daratneter in the SELECT ESR is defined for the 1827 
line priitep as foiloMst 

2 3 

9 1 
♦ . . . ^ ^ 

f^eg 1*1 I t M 1 
♦ — ^ ^ 

i = Select 96 ASCII character set. 

1 = Select bi* ASCII character set. 

2 = Fold 96 into 6k ASCII character set. 

rne HOD£ oaraaeter in the SELECT ESR is defined for the 1860-'t 
nagnetic tape as follows: 

3 

1 

f ^.^ 

Reg f^fl J ll^i 

♦ ... . . . ^.^^, 

1 = Select low recording density. 

1 = Select high recording density. 

Tf^a_MOO£ paraaieTer in the SELECT ESR is defined for the 2558-3 
CY3:iR Cian-iel Couolsr as foiiows: 

3 

1 

♦ ., ... , . . ^.^ 

Reg tH J ]Hi 

♦ ^.^ 

A 



o 



ML> 



3-3 



CCS-IQOl-A 



o 



o 



o 



o 



H!>X/3S I/O Subsystem External Reference Specification 



T?i6 MODE paranetep in the SELECT ESR is defined for Interactive 
Te^Binals and Reaote Batch as foiloMst 

2 2 2 3 3 

° 7 8 9 1 



Reg n*l i 



♦ . .. -—...-._—<.. +.<..4.+.+ 



tQIPIOIBiCi 



♦ --- . .... . — .. , — ... + .4._<._4.^.^ 

-C = 9b ASCII character set (default). 

1 = Sk ASCII character set (96 folded into 6<») . 

B = Line mode (default). 
1 = Bloci* mode (default). 

s Enable auto-prompt (default). 
1 = Disable auto-prompt. 

P = Use prompt already defined (default). 
1 = Next WRITLU defines lew prompt, 

Q. « Do nat queue received data (default). 

1 = Queue received data and status. 

Tne CODE Darameter in the FUNC ESR is defined for the 2558-3 
CriER C'^aniel Couoler as follows: 

3 
1 

♦ ♦-♦ 



Reg •»♦! J 

♦ i-+ 
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T^a C00£ paramster in the J=:|fJC 1:SR i s defined for the Local CRT, 
3CLA, and HPCLA as followsi 

11 3 

5 6 1 

Reg 1*1 J Sub- function i Parameter I. 

3u3-fui:tion -- Define Peripheral Interface TableCPITJ, the 

paramter specifies the first word address of 
the PIT. 

1 -- Read address in PIT* the parameter specifies 

the port. 

2 -- Write buffer address im PIT, the parameter 

specifies the oort. 

3 -- Port Setup in PIT, the parameter specifies 

the port. 

k -- Clear a port, the parameter specifies the 
port. 

Tie Peripheral Interface Table (PIT) is used to communicated 

port luTit) information to the device manager. The PIT contains 4_> 

ai ent-y far each port or unit and an entry has the following 

f ormat : 

11 2 2 3 
78 56 3 t* 1 

a JOJ S byte count i ouffer address/status 1 

4...... 4...... --♦ ....4... ,-.--.-_4. 

1 101 I byte count I buffer address/status S 
....... ...... 4....... ..4.. ...... ....4.. ....... 4. 

2 I Port Setup I 
4....... ..4...... ..4....... .....4........ 4 

3 I Flags I 

4._-_-_-.__. -4.-. _..-_. 4.--. ...... ..4.. ........4. 

Mo-d 3its Definition 

Control bit (0=svst6», l=device manager). 

2-13 Number of bytes not used in received buffer. 

lif-Ji Receive buffer first byte address. 

16-31 Status (see below) 



rT^. 
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2 
3 



Control bit (O^system, l=clevice manager) 

2-13 Number of bytes not transmitted. 

1!»-31 TransmiT buffer first byte address* 

15-31 Status (see below), 

Port/Unit setup inf o-nation (see belOMl. 
Flags useable by device nanager. 



rna status field in the PIT has the following definitions for 
tie ass3ciared device: 



o 



Ldcai 

i?»CLA 

Bit 

21 
22 
23 
2% 
25 
25 
ZT 
30 
31, 



11112 2 2 
6 7 8 9 12 

4--* -4--4'.«-.4-« «■.■«■ 

;^T J jBi 
♦-♦-♦-♦-♦-♦-♦-♦ 

i IFIBi 

) }FiBi 

+ - + -+-♦-♦-♦.-+» + 



2 2 2 2 2 

3 *» 5 6 7 

LIHJPJ ICI 

LiHiPj :ci 
-♦-♦-♦-♦-♦ 

LtHIPIXJCi 
♦-♦- ♦-♦-*■ 



Def ini tion 



Framing error. 
3reak detected. 
Dvarrun/Jnderrun. 
iardware Error. 
Paf*ity £rror » 
ChecKsun srror, 
Sarrier aot on. 
Data set not ready 
E.rrsir flag. 




2 2 3 3 
8 9 1 
-.4-4—4.-4. 

Oi IRIEI 
-♦-♦-♦-4 

Ot IRIEl 
-4.- 4. .(..4. 

Oi IRIEI 



# 






Tne port setuo field in the PIT ftas the following definitions 
for the associated device: 

11 3 

5 6 1 

♦ ♦ ♦ 

3CLA 1 J 

♦ 4 

HPCLA 2 , 

♦ - - - ♦ 
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APPENDIX C VALID HARDWARE TYPES 

THE VALID HARDWARE TYPES WHICH CAN BE REQUESTED rtlTH THE EQUIP AND 
DEVICEQ ESRS AND THE HARDWARE TYPE FIELD RETURNED BY THE UTYP ESR 
ARE AS FOLLOWS: 



o 



o 



HARDWARE 


MNEMONIC 


TYPE 


DEVICE 


TYPE CODE 






IDENTIFIER 





MEM 


MEMORY 


NA 


1 


DP 


MASS STORAGE 


PACK NAME 


2 


MT9 


MAGNETIC TAPE (9-TRACK) 


MT9 N_ 


3 


CR 


CARD READER 


CARD N_ 


4 


CP 


CARD PUNCH 


PUNCH_N_ 


b 


LP 


LINE PRINTER 


LINE N_ 


6 


CRT 


OPERATOR CONSOLE 


CRT N_ 


7 


TT 


TELETYPE 


TT N_ 


8 


CT 


CARTRIDGE TAPE 


CT N_ 


9 


PLT 


PLOTTER 


PLT N_ 


10 


FDD 


FLEXIBLE DISK 


FDD N_ 


11 


ccc 


CYBER COUPLER 


CCC N_ 


12 


MT7 


MAGNETIC TAPE {7-TRACK) 


MT7 N_ 


13 


IT 


INTERACTIVE TERMINAL 


NA 


14 


RBT 


REMOTE BATCH TERMINAL 


NA 


15 


CN 


COMMUNICATIONS NETWORK 


NA 


16 


MO 


MESSAGE QUEUE 


D/S NAME 


17 


MUX 


MUX 


MUX N_ 






BCLA 


BCLA__N_ 


18 


SMX 


MPCLA (ZdO-A) 


MPCLA.NA 






MPCLA (Z80-B) 


MPCLA_NB 
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Apoendix 3 HPX/OS ERROR RECOVERY PROCEDURES 

Tha HPX/05 error recovery procedures are dependent upon ffxe 
device and error status codes returned by the device nanagers. 
T^s rec3we~y tecrt^iques irployed for each error status code and 
associated devices are described i^ the fol lowing paragraphs. 

8u.5y - 3it 31 set and no other erro" bits set, 
A I i Jet/i ces 

The request is retired periodically and/or until the 
associated device manager generates an end of operation. 

Not Ready - 3i t 31 and 30 set» and not other error bits. 
A i I Oev/i ces 

The operator is notified and tns request is retired every 5 
seco-ids. 

Data Error - 3it 31 and 25 set. 

Lost Data - Bit 31 and 23 set. 

Mass Storage 

The request is retired three (3) times. 

Taoe 

The fol lowing sequence is executed* 

1) Sacicspace 

2) Retry operation 

3) Repeat 18,2 three times 

Read Write 

kl Skio back 3 records hi Baclfspace 

5» 5Kip 2 records forward 5) Erase 

5) Retry operation 6) Repeat 1-5 three times 
7) Repeat 1-6 three times 
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A 1 1 others 

Notify operator and await response of Accept (retryl or 
Re] set (no-retry). 



O 



Hardware -.Tor - Bit 31 and Zk set. 
A I i Det/ices 

The operator is notified and the error is considered 
irrecoverab I e* 

Address Irrsr - Bit 31 and 22 set. 
Hass Storage Only. 
The following sequence is executed^ 

1) Return to zero seek. 

2) Retry ^Deration. 

3) Repeat 1-2 three (3) tiraas. 



Seek Error - Bit 31 and 21 set. 
rtass Storage Onl y. 
The 3peratiof> is retried three (3) times. 



%J 



Arite Pfatect Fault - Bit 31 and 27 set. 

Mass Storage and Tape only 

The oparator is notified and await response. If the operator 
Acceots then the operation is retried? otherwise the 
operation is coisidered irrecoverable. 

Fead Failure - Bit 31 and 27 set. 
I-iaut T-ay Emoty - Bit 31 and 23 set. 

Car:l Reader Only. 

The aparator is notified and await response. If the operator 
Acceots then the operation is retried; otherwise the error 
is considered irrecoverable. 
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Paaer FajJt - Bit 31 and 21 set. 
Pri^te" Or»|y. 

The aoarator is notified and await response. If the operator 
Acceats then the operation is retried? otherwise ihe error 
iS considered irrecoverable. 

I'M of Tape - ait 3i and 21 set. 
Hag-ietic Tape only. 
The taoe is unloaded and the operator is notified. 
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